Skip Headers

Oracle Procedural Gateway® for WebSphere MQ Installation and User's Guide 10g Release 2 (10.2) for UNIX Part Number B16215-01 |
Home | Book List | Contents | Index | Master Index | Feedback

Previous | Next
| View PDF

# 5 Installation

This chapter describes the installation of the Enterprise Edition of Oracle Procedural Gateway for WebSphere MQ. It contains the following sections:

- Installation

- Running root.sh

## Installation

Table 5-1 guides you through the installation process. For each screen, perform the actions described in the Response column.

Table 5-1 Installing the software

Screen | Response
--- | ---
Welcome | Click Next.
File Locations | The Source section of the screen is where you specify the source location that Oracle Universal Installer uses to install Oracle Procedural Gateway for WebSphere MQ. You need not edit the file specification in the Path field - the default setting for this field points to the Oracle Universal Installer file on your Oracle Procedural Gateway for WebSphere MQ CD-ROM. The Path field in the Destination section of the File Locations screen is where you specify the destination for your installation. You need not edit the path specification in the Path field. The default setting for this field points to `ORACLE_HOME`. After you set the fields in the File Locations screen, as necessary, click Next to continue. After loading the necessary information from the CD-ROM, the installer displays the Available Products screen.
Available Products | Select Oracle Database 10g and click Next to continue. Oracle Universal Installer displays the Installation Types screen.
Installation Types | Select Custom and click Next to continue. Oracle Universal Installer displays the Available Product Component screen.
Available Product Components | Use the check boxes to indicate the product components that you want to install. By default, all the available components are selected for you. You need to de-select the components that you do not want by clicking on the check boxes. Click Next to continue, and Oracle Universal Installer displays the Where is the WebSphere MQ Queue Manager Installed ? screen.
Where is the WebSphere MQ Queue Manager Installed ? | Select Local if the MQM runs on the same system as the gateway, or select Remote if the MQM runs on a different system than the gateway. Click Next to continue.
Local WebSphere MQ Queue Manager Name | If you choose Local for your MQM in the Where is the WebSphere MQ Queue Manager Installed? screen, then the Local WebSphere MQ Queue Manger Name screen is displayed. Type in the local WebSphere MQ queue manager name in the Queue Manager field. Click Next to continue, and Oracle Universal Installer displays the Summary screen.
Remote WebSphere MQ Queue Manager Name | If you choose Remote for your MQM in the Local WebSphere MQ Queue Manager Name screen, then the Remote WebSphere MQ Queue Manager Name screen is displayed. Enter the name for the remote WebSphere MQ queue manger in the Queue Manager field, and also enter the WebSphere MQ channel name in the Channel field. For information about server connection channels, refer to the IBM publication about WebSphere MQ Clients or ask your WebSphere MQ system administrator for the channel definition of the queue manager to which you want the gateway to connect. The definition syntax is:
    CHANNEL_NAME/PROTOCOL/server_address[(port)]
where `CHANNEL_NAME` and `PROTOCOL` must be in uppercase, and `server_address` is the TCP/IP host name of the server. Teh port value is optional and is the TCP/IP port number on which the server is listening. If you do not provide a port number, then WebSphere MQ uses the port number that is specified in the `QM.INI` file. If no value is specified in the `QM.INI` file, then WebSphere MQ uses the port number that is identified in the TCP/IP services file for the WebSphere MQ services name. If this entry in the services file does not exist, then the default value of `1414` is used. It is important that the port number that is used by the client and the port number that is used by the server listener program be the same.
Oracle Universal Installer Summary | This screen enables you to review a tree list of options and components for this installation. Click Install to display the Installation Status screen.
Installation Status | The Installation Status screen displays the status of the installation as it proceeds, as well as the location of the Oracle Universal Installer log file for this installation session. Be patient as Oracle Universal Installer processes the software installation. Depending on the CPU, CD-ROM drive, and hard drive on your system, the installation process might take time to complete.
End of Installation | This is the final screen of Oracle Universal Installer in the installation process. Assuming that your installation was successful, click Exit to exit the installer.

## Running root.sh

After you complete the installation, perform the following steps to run the `root.sh` script:

1. Log on as the `root` user.

2. Go to the `$ORACLE_HOME/pg4mq/admin` directory for your WebSphere MQ gateway.

       prompt> cd $ORACLE_HOME/pg4mq/admin

3. Run the `root.sh` script.

       prompt> ./root.sh

   This script enables the WebSphere MQ gateway to operate for the strict security model.

4. Exit the `root` account.